home *** CD-ROM | disk | FTP | other *** search
/ Internet Surfer: Getting Started / Internet Surfer - Getting Started (Wayzata Technology)(7231)(1995).bin / pc / textfile / mac_faqs / 3b2_faq next >
Internet Message Format  |  1995-01-27  |  70KB

  1. Xref: bloom-picayune.mit.edu comp.sys.att:16586 news.answers:4747
  2. Path: bloom-picayune.mit.edu!enterpoop.mit.edu!hri.com!noc.near.net!uunet!olivea!pagesat!spssig.spss.com!uchinews!machine!gagme!gagme!greg
  3. From: greg@gagme.chi.il.us (Gregory Gulik)
  4. Newsgroups: comp.sys.att,news.answers
  5. Subject: AT&T 3B2 (and related) Frequently Asked Questions and Answers
  6. Message-ID: <1992Dec21.223107.11981@gagme.chi.il.us>
  7. Date: 21 Dec 92 22:31:07 GMT
  8. Sender: usenet@serveme.chi.il.us
  9. Followup-To: comp.sys.att
  10. Organization: GAGME Public Access UNIX, Chicago, Illinois, USA
  11. Lines: 1775
  12. Approved: news-answers-request@MIT.Edu
  13. Originator: greg@gagme
  14.  
  15. Archive-name: 3b2-faq
  16.  
  17.               AT&T 3B2 FREQUENTLY ASKED QUESTIONS
  18.  
  19. This article contains the answers to many Frequently Asked Questions
  20. (FAQ) often posed to the net. It is posted because the same questions
  21. pop up time after time. This will hopefully help out by not having
  22. these questions posted over and over, and help new users know what
  23. questions there are to ask in the first place! 8^)
  24.  
  25. This article includes answers to the following questions.  Much of the
  26. information included in this article is compatible with the 3B2 series
  27. of WE32000 series based computers.
  28.  
  29. First, the questions:
  30.  
  31. Subject:  0 SPECIAL NOTE
  32. Subject:  1 How do I install a second ST-506 drive on my 3B2?
  33. Subject:  2 How do I create a second swap partition?
  34. Subject:  3 How can I get X11 for the 3B2?
  35. Subject:  4 How do I install a non AT&T SCSI drive on my 3B2?
  36. Subject:  5 How do I prevent data overrun errors when using a high
  37.             speed modem on an EPORTS card at 19.2K baud or higher?
  38. Subject:  6 What does the 'NOTICE: File Table Overflow' error mean?
  39. Subject:  7 How do I set up anonymous ftp?
  40. Subject:  8 Is there a reposity of ftp-able 3B2 programs?
  41. Subject:  9 How do I run Unix from floppy (for example, to repair a damage
  42.             hard drive file system)?
  43. Subject: 10 What is/was the 3B Journal?
  44. Subject: 11 What are the various models of 3B2s and their differences?
  45. Subject: 12 How do I build GCC on the 3B2?
  46. Subject: 13 What is the NVRAM SANITY FAILURE?
  47. Subject: 14 Is there an implementation of SLIP for the 3B2?
  48. Subject: 15 What are the known bugs in the Wollongong WIN TCP software?
  49. Subject: 16 Is there an implementation of NFS for the 3B2?
  50. Subject: 17 What are the pinouts of those phone-like serial connectors?
  51. Subject: 18 What is the u3b. newsgroup heirarchy?
  52.  
  53. Now, the answers:
  54.  
  55.  
  56. ------------------------------------------------------------------------------
  57. Subject:  0 SPECIAL NOTE
  58. ------------------------------------------------------------------------------
  59.  
  60. If you are going to be at all serious about the 3B2, and especially if
  61. you are relying on yourself for maintenance, the first thing you want
  62. to do is obtain the AT&T 3B2 Computer Maintenance Manual.
  63.  
  64. It contains diagrams of all 3B2 computers up to the 3B2/600, parts
  65. lists, breakdown procedures, troubleshooting information, and sources
  66. of additional documentation.
  67.  
  68. In addition, it contains the "3B2 Computer Maintenance Utilities"
  69. diskette called "idtools" (formerly known as "devtools").  This floppy
  70. is bootable, and once running, the following options are available:
  71.  
  72.         > format floppy diskettes
  73.         > format hard disk drives
  74.         > verifies hard disk format
  75.         > disk-to-disk high speed copies
  76.         > disk-to-disk copy by sectors
  77.         > disk-to-memory copies
  78.         > defect table builder
  79.         > writes sanity track
  80.         > change default boot information
  81.  
  82. While some of these options are also available from UNIX, all the
  83. utilities here can be run on a machine with a damaged (or missing) hard
  84. disk, often allowing the drive to be repaired that is otherwise
  85. unbootable.
  86.  
  87. This manual and disk can be ordered from the AT&T Customer Information
  88. Center in Indianapolis, IN.  It has select code 305-395, and at press
  89. time it sold for about $125.  The AT&T CuIC can be reached at:
  90.  
  91.     (800) 432-6600    Continental US
  92.     (317) 322-6556    elsewhere
  93.  
  94. The CuIC takes phone orders with a credit card, and with a purchase
  95. order for qualifying companies.  They have many other UNIX-related
  96. books as well, so be sure to ask for their free "AT&T Documentation
  97. Guide", select code 000-011.
  98.  
  99. ------------------------------------------------------------------------------
  100. Subject:  1 How do I install a second ST-506 drive on my 3B2?
  101. ------------------------------------------------------------------------------
  102.  
  103. Copyright 1989 by Owens-Laing Publications.
  104.  
  105. Title:  Disk Expansion on the 3B2
  106. Author: Stephen Friedl (friedl@mtndew.Tustin.CA.US)
  107. Issue:  3B Journal, 4Q 1989
  108. [Edited by Gregory Gulik]
  109.  
  110. [ conventions are:  *bold* and _italics_ ]
  111.  
  112.  Introduction
  113.  ------------
  114.  
  115. The 3B2/400 family (/300, /310 and /400) computers use standard MFM
  116. disk drives, and it is possible to add or replace these drives yourself
  117. -- in this article we show you how to do this.
  118.  
  119. The 3B2/500 and larger machines all have SCSI (Small Computer Systems
  120. Interface) disk drives, so these instructions do not apply to them.
  121. For the duration of this article, "3B2" means the 3B2/400 and below,
  122. and in the case where there are differences among these included models
  123. we will mention them.
  124.  
  125. Before doing any drive replacement, you must obtain the _3B2 Computer
  126. Maintenance Reference Manual_ from AT&T.  This document contains quite
  127. a bit of useful information about your 3B2 hardware, and it is helpful
  128. in its own right.  What makes it so special is the "idtools" diskette
  129. that comes with it.  This floppy disk contains numerous utilities that
  130. will help you diagnose and troubleshoot your computer, as well as the
  131. disk formatting tools we need for our expansion project.
  132.  
  133.  What we don't tell you
  134.  ----------------------
  135.  
  136. This is a fairly technical topic, and it relies on substantial
  137. knowledge of UNIX system administration.  Those steps directly related
  138. to the formatting operation are covered here, but others such as backup
  139. and restore from tape, disk space allocation, and rebooting the machine
  140. are prerequisite knowledge.  AT&T's sysadm documentation covers a great
  141. deal of it, but if these things are new to you, perhaps you're not
  142. ready to give this a go just yet.
  143.  
  144. Please keep in mind that if this is not done correctly (especially the
  145. backups), you could lost most or all of your computer's data in a very
  146. short time.  You must have at least one full, verified backup of all
  147. filesystems, with _two_ backups being safer.  In addition, it is a good
  148. idea to try this during an off time when you can afford to be down for
  149. while if things don't go so well.
  150.  
  151. Finally, we have tried to present this information as accurately and
  152. clearly as we can, but we cannot guarantee that there are no bugs.
  153. Check everything, verify steps with the manual, and ask a local wizard
  154. if you get stuck.  Of course, you undertake this procedure at your own
  155. risk.
  156.  
  157.  Selecting a drive
  158.  -----------------
  159.  
  160. There are many drives on the market that are satisfactory, and we
  161. present some guidelines here for selecting one.  We have our favorites,
  162. but most available ST-506 drives can be used in the 3B2.  Note that
  163. these are suggestions only, not endorsements or guarantees of
  164. compatibility.
  165.  
  166. The first restriction is that the idtools software will not format more
  167. than 1024 cylinders in a single drive, and a drive with more will
  168. simply have the excess cylinders ignored.  This is an unfortunate but
  169. unavoidable waste of disk space, giving us a practical limit of about
  170. 135Mbyte.  (15 heads x 1024 cyls x 18 blks/track x 512 bytes/block).
  171.  
  172. Most of the drives found in the original 3B2 are made by Control Data
  173. (or their subsidiary, Imprimis), and these Wren II drives are of
  174. excellent quality, and they represent a very safe route.  These drives
  175. are available with formatted capacities of 30 and 72 megabytes, and
  176. they have an average access time of about 28 msec.  Other brands known
  177. to work include Maxtor, Miniscribe, Priam, Micropolis and others.  Some
  178. of these drives have more than 1024 cylinders which allows them to be
  179. used, but at less than their advertised capacity.
  180.  
  181.  Disk types and the Equipped Device Table
  182.  ----------------------------------------
  183.  
  184. Each drive in the 3B2 is formatted with a _disk type_, which is a small
  185. number that identifies the drive to the machine.  The disk type indexes
  186. into a table of drive information, and this table is part of the
  187. /dgn/edt_data file.  This file is used to fill the Equipped Device
  188. Table, a list of currently-available hardware devices maintained by the
  189. firmware.  Part of this list, the _subdevice table_, describes the
  190. possible hard disk drives.
  191.  
  192.  Getting started
  193.  ---------------
  194.  
  195. Now that the formatting tools have arrived and a drive has been
  196. obtained, we are ready to do the installation.  It is at this point
  197. that a full backup of the entire system is in order and to review the
  198. relevent portions of the Maintenance Manual.
  199.  
  200. After backing up the current drives, shut down the machine, turn off
  201. the power, and remove the power plug.  Open the case, note the current
  202. configuration of the drive cables, and remove them along with the power
  203. connectors.
  204.  
  205. Select "drive 0" on the drive select jumpers, insert/enable the
  206. terminating resistor, and place the drive back in the cage.  Connect
  207. drive zero's data cable (the thin ribbon cable), the last connector on
  208. the wide control cable, and the power cable to the rear of the drive.
  209. Pay particular attention to pin one orientation, and insure that all
  210. connections are snug.
  211.  
  212. At this point you are ready to turn on the machine.  Plug in the 3B2
  213. power cable and turn the switch to "ON".  The console should show a
  214. SELF CHECK, followed shortly by
  215.  
  216.     FW ERROR 1-02: DISK SANITY FAILURE
  217.                EXECUTION HALTED
  218.  
  219.     SYSTEM FAILURE: CONSULT YOUR SYSTEM ADMINISTRATION UTILITIES GUIDE
  220.  
  221. This ominous message is actually expected, and it just means that the
  222. disk drive is not formatted yet.  At this point, type your current
  223. firmware password (usually "mcp") followed by RETURN, and you will be
  224. presented with the normal firmware menu.
  225.  
  226. At this point you should boot "/idtools" from the floppy drive (load
  227. device 0, FD5).  Once booted, idtools displays an informational message
  228. and asks that RETURN be hit.
  229.  
  230. Note that this entire process is covered in Appendix B of the
  231. Maintenance Reference Manual, and we strongly recommend that you review
  232. sections
  233.  
  234.     Hard Disk Formatter (B-8),
  235.     Defect Table Builder (B-33), and
  236.     Writing Sanity Track (B-47)
  237.  
  238. plus the introduction before continuing.
  239.  
  240.  Running Idtools
  241.  ---------------
  242.  
  243. At the first menu, "formhard" should be entered.  It will ask which disk
  244. should be formatted, and the proper response is zero in most cases.  If
  245. you are doing this procedure on a machine with two drives installed, be
  246. _very_ careful when answering this question.
  247.  
  248. Next, you are asked for drive configuration information.  You must
  249. enter the drive type (from a previous section) plus the drive
  250. dimensions, and the following table summarizes several models we know
  251. about.  If your drive is not shown, consult your vendor documentation
  252. for this information.
  253.  
  254. Drive type    drv id    cyls trk/cyl sec/trk byte/cyl     abbrev
  255. --------------- ------    ---- ------- ------- --------      ------
  256. Wren II 30MB       3     697     5    18    512       HD30
  257. Wren II 72MB       5     925     9    18    512       HD72
  258. Fujitsu M2243AS       8     754    11      18      512       HD72C
  259. Micropolis 1325    5    1024     8      18      512       HD72
  260. Maxtor 1140       4*     918=    15    18    512       HD120
  261. Maxtor 1190      11    1224+   15    18    512       HD135
  262. Miniscribe XXXX    4*
  263. Priam XXXX
  264.  
  265. * selected by user
  266. + can only use 1024 cylinders on this drive
  267. = can usually be formatted out to 1024 cylinders, even though it is
  268.   actually capable of 1224 cylinders, like the 1190.
  269.  
  270. Note that "tracks/cylinder" means "heads", and the sectors/track and
  271. bytes/cylinder values the same for all drives.  The drive ID is shown
  272. as 4 for high-capacity drives, and it assumes that this number was
  273. inserted into the Equipped Device Table subdevice listing.
  274.  
  275. In the following examples, user responses are in *bold*, and the drive
  276. shown is a Maxtor 1140.  Note that the default entries shown may vary
  277. from machine to machine.
  278.  
  279.     Format which disk [ 0 or 1 ] (0)?  *0*
  280.  
  281.     Drive id: 3- ? *4*
  282.     Number of cylinders: 687 - ?  *918*
  283.     Numbers tracks/cyl: 5 - ?  *15*
  284.     Number sectors/track: 18 - ? *18*
  285.     Number bytes/sector: 512 - ? *512*
  286.  
  287. Once these values have been entered, idtools shows where it will place
  288. various housekeeping areas on the disk, almost all stored on the first
  289. two cylinders.  You need not concern yourself with the specific values
  290. printed.
  291.  
  292.  Defect Mapping
  293.  --------------
  294.  
  295. The bad block listing (with various alternate names, such as "Flag
  296. Track Log") is usually found on a sticker on top of the drive.  To
  297. simplify data entry, it is a good idea to photocopy this sticker while
  298. it is on the drive, because later the drive might not be in such a
  299. comfortable reading position (especially if it is in a drive cage).
  300.  
  301. The first prompt in this section asks if the backup defect table should
  302. be modified.  A formatted drive normally has two copies of the defect
  303. table on disk in case one is lost, but a blank drive has no such
  304. table.  Answering "yes" to this question means that the data you enter
  305. here is stored in both places.
  306.  
  307. To enter the defects, enter "new" when asked, then "bc" for the type of
  308. defect byte count.  Then, for each bad sector, enter the cylinder
  309. number, the head number, and the byte count, all separated by spaces.
  310. This "byte count" field is often shown on the disk label as "BFIND"
  311. (bytes from index) or "BCAI" (byte count after index), and it is
  312. distinct from the sector number.  Most entries have a block length of
  313. one, but if the label shows more than this then it must be the fourth
  314. field on the line.
  315.  
  316. An entry of "q" terminates the input, and displays the entire list of
  317. blocks entered.  It is vital that this list be checked completely, and
  318. edits made if necessary.  An entry of just a RETURN accepts the current
  319. list and moves onto the next prompt.
  320.  
  321.                Format entire disk - type 1
  322.               Format single track - type 2
  323.     Format from selected track to end - type 3
  324.  
  325.     Select type of format [1, 2, or 3] (1) ?
  326.  
  327. Entering "1" followed by RETURN starts the formatting process, and when
  328. it completes it starts a verify pass where all blocks on the disk are
  329. examined for errors.  This operation can take some time on a large
  330. drive, and idtools shows its progress with a message displayed every
  331. five cylinders formatted.
  332.  
  333. After the format and verify, idtools writes the "sanity track" with the
  334. "fixdisk" program.  The sanity track contains a special data pattern
  335. that validates the drive to the 3B2, and it takes just a moment and
  336. requires no input from you.
  337.  
  338. With the conclusion of the fixdisk operation the drive is formatted.
  339. You can remove the idtools floppy and power the machine down.
  340.  
  341.  Closing up the machine
  342.  ----------------------
  343.  
  344. The machine should now be put back together and the original drives
  345. reinstalled.  It is important that all drive selects and terminating
  346. resistors be installed properly, following the rules mentioned
  347. previously.
  348.  
  349. The first drive in the machine has the lowest drive select jumper
  350. (usually position zero) and connected to the zero data cable (usually
  351. the bottom drive).  The second drive in the machine has the next drive
  352. select (usually position one) and the other data cable, and the control
  353. cable connects them both.  The drive that is at the physical end of the
  354. control cable must have the terminating resistor.
  355.  
  356. Disk drives installed into an XM expansion module have special rules on
  357. termination, and these are documented and diagramed on pages 6-23 and
  358. 6-24 of the Maintenance Reference Manual.
  359.  
  360.  Partitioning the drive
  361.  ----------------------
  362.  
  363. The easiest case is adding a second drive to a machine that previously
  364. had only one.  After installing the new unit, boot /unix from the hard
  365. drive and enter single-user mode (this is much easier if you have
  366. edited /etc/inittab).
  367.  
  368. With the /usr partition mounted, run the "sysadm" command, and at each
  369. successive menu, enter "diskmgmt", "harddisk", and "partitioning" in
  370. turn.  This enters the partitioning operation and it should prompt you
  371. for the relevant information.  We do not discuss strategies for
  372. allocating filesystem resources, as this is covered in the AT&T system
  373. administrative documentation.
  374.  
  375. Once the drive is partitioned, the added filesystems (say, /usr2 and
  376. /usr3) may be used immediately.
  377.  
  378. All other cases involve replacing existing drives, and it most
  379. expedient to use the full restore procedure for this.  A full backup is
  380. absolutely required here for this operation, and it should be verified
  381. once it is made.
  382.  
  383. Boot the "Essential Utilities - Disk 1" floppy and select the "Full
  384. Restore" operation.  This procedure includes a partitioning step that
  385. allows you to allocate your new disk resources.  Follow the
  386. instructions shown on the screen.
  387.  
  388. After the core set of floppies -- five or six disks -- you can
  389. interrupt this process, boot /unix from the hard disk, and restore all
  390. of your backups.  You may have to install the Cartridge Tape Utilities
  391. if your backups are stored on that medium.
  392.  
  393. WARNING: This "full restore" operation destroys all data on all hard
  394. disks during the partitioning, and you _must_ have a full set of
  395. reliable, verified backups before considering this step, and two full
  396. sets of backups would not be a bad idea.  If these backups are not done
  397. properly, all data on the disks will be LOST.  Please be very careful
  398. when doing this, as mistakes can be costly.
  399.  
  400.  Compatibility note
  401.  ------------------
  402.  
  403. Some early models of the 3B2/300 do not permit a 72MB hard drive to be
  404. added to the system board.  The recognizing signs for this restriction
  405. are documented in the Maintenance Reference Manual on page 7-21, and
  406. 3B2/300 owners should consult this information before starting this
  407. project.
  408.  
  409. While the documentation does not mention the reason for this
  410. restriction, we speculate that any drive with more than eight heads
  411. cannot be used in these older machines.
  412.  
  413. ------------------------------------------------------------------------------
  414. Subject:  2 How do I create a second swap partition?
  415. ------------------------------------------------------------------------------
  416.  
  417. These are the steps I used to add a second swap partition to my
  418. 3B2/400.  Why add a second  swap area?   By default, the SVR3.1
  419. system disks (the version I use) make one swap area of 10196 blocks
  420. on the first hard disk (/dev/rdsk/c1d0s1).  While this 5Mb area
  421. seems plenty for most uses, I managed to exhaust it.  It was time to
  422. RTFM.  While the manual gives you the confidence to say that you *can*
  423. increase the number of swap partitions, it doesn't clearly tell you
  424. exactly how to go about doing that.  What follows are the steps you
  425. can follow to add another swap partition to your system.
  426.  
  427. Are you adding this swap space "just to balance the load"?  If so,
  428. forget it.  The effect is negligible and clearly not worth the effort.
  429. I have been unsuccessful in conclusively proving whether or not SVR3.1
  430. does perform balanced allocation of the swap space.  It seems to knock
  431. a huge chunk off the first partition before it even touches the second
  432. one.  I would not think of doing this unless you have SVR3.1 or
  433. SVR3.2.  Earlier versions do not have the advanced swap handling
  434. functions, and may not even allow you to do this.  Upgrade time.
  435. The only reason to add another swap partition is if you have a valid
  436. reason to do so (i.e. you have exhausted your present swap space).
  437. Remember that swap cannot be used for anything else, you take space
  438. away from your mountable filesystems when you add swap space.
  439.  
  440. Please keep in mind that this is *your* system, and these steps can
  441. easily wipe out all your data files.  Take adequate care to back
  442. up your data.  Make sure your backups work before you start any of this.
  443.  
  444. IT IS STRONGLY RECOMMENDED THAT YOU HAVE A PAPER COPY OF THESE
  445. DIRECTIONS IN FRONT OF YOU AS YOU PERFORM THIS TASK.
  446.  
  447. Step 0: BACK UP THE SYSTEM!  I cannot stress this enough.
  448.         If you have a tape drive, use that in preference over the
  449.     floppy drive.  Back up the /, /usr, and /usr2 partitions.
  450.     While it is not mandatory, it's also a good idea to back up
  451.     everything else just in case catastrophe strikes.  Expect the
  452.     worst and hope for the best.
  453.  
  454. Step 1: Reload the Foundation floppies and select a custom partition
  455.         setup.  Pick the sizes you want for the new swap partitions.
  456.     Since you are adding a second swap partition, it is up to you
  457.     if you wish to add to (or keep) the original 5Mb swap
  458.     partition.  It is mandatory that you keep *some* swap space on
  459.     the first disk.  There is no rule that says the 2 partitions must
  460.     be equal in size.  Finish the full restore.
  461.  
  462.     For Your Information: the sizes of the partitions are
  463.     dependent on the number of blocks per cylinder group.  That
  464.     means, you can specify size in units of (18 * number of
  465.     heads).  If you specify a number that is not a round figure,
  466.     the machine will round it for you.  RECORD THIS NUMBER!!!
  467.     This new partition will be named /usrX (where X is a positive
  468.     integer) and there will be a filesystem made upon it.  Do not worry.
  469.  
  470. Step 2: Bring up unix, log in as root, and bring the machine to runlevel 1.
  471.         When the machine is in single-user mode, make sure that all
  472.     disk partitions are unmounted (except for the root partition!)
  473.  
  474. Step 3: Make a temporary file with the existing partition data:
  475.  
  476.         # prtvtoc /dev/rdsk/c1d1s6 > /tmp/disk.data
  477.  
  478. Step 4: Edit the disk.data file.  Make the following changes:
  479.         change the tag field from 0 to 3 (from 'user' to 'swap')
  480.         change the flags from 00 to 01 (unmountable partition)
  481.         delete all the initial comments (lines with initial *'s)
  482.     Double check this file to make sure you got it right
  483.  
  484. Step 5: Save this data back to the hard disk.  If you choose to chicken
  485.         out, do it BEFORE THIS STEP:
  486.  
  487.         # fmthard -s /tmp/disk.data /dev/rdsk/c1d1s6
  488.  
  489. Step 6: Edit /etc/fstab to remove the reference to the now defunct
  490.         filesystem.  You don't have to do anything else to the actual
  491.     partition to remove the filesystem - the system will page over
  492.     the superblock and inode lists by itself.
  493.  
  494. Step 7: Use /etc/swap to tell the system that the partition is ready
  495.         for paging/swapping.  The best way to do this is to make the
  496.     system add this partition each time it boots.  Create a file
  497.     called /etc/rc2.d/S00SETSWAP.  Link it to the file
  498.     /etc/init.d/S00SETSWAP.  In this file, add the following line:
  499.  
  500.     /etc/swap -a /dev/dsk/c1d1sYY 0 XXXXX
  501.  
  502.     In this case, the Y's in the disk name should be set to the
  503.     disk partition that the new swap space is to be located on.
  504.     Usually, this is partition 8 (if you specified the swap space
  505.     as the first partition on the disk before /usr).  The 0 (zero)
  506.     signifies that swap activity is to start at the 0th block of
  507.     the partition - the start.  Replace the XXXXX with the number
  508.     of blocks available in the partition.  This is the number you
  509.     recorded in Step 1 above.
  510.  
  511. Step 8: Reboot and pray.  If it all went well, the machine will come
  512.         up in multi-user mode.  Once again, log in as root and bring
  513.     the machine down to single-user state.  Make sure that the
  514.     system is actually using the new partition with the 
  515.  
  516.     # /etc/swap -l
  517.  
  518.     command.  You should see the original swap partition
  519.     (/dev/dsk/c1d0s1) as well as your new partition listed.
  520.  
  521.     If your machine did not boot for some bizarre reason, reload
  522.     the system again (go to step 1), making sure that you do
  523.     everything correctly.
  524.  
  525. Step 9: Restore your data.  If you backed up on floppy, just restore
  526.         them in order and reboot.  If you backed up on a CTC tape drive,
  527.         you must install the Cartridge Tape Utilities disk, reboot,
  528.         recover your data, and reboot one last time.  IF you didn't back
  529.         up your data, then you're SOL.
  530.  
  531.         A note to those with XDC and SCSI drives - the maneuvers you
  532.         have just completed only messed up the data on the 2 internal
  533.         disk drives.  Any data on your 3rd (and higher) drives should
  534.         remain untouched.  
  535.  
  536. There is another way to do this whole thing without reloading the
  537. entire OS.  It involves having a boot floppy with prtvtoc, fmthard,
  538. swap, and a few other files on it.  You would have to make this before
  539. hand (explained in a different question).  In this instance, you would
  540. only alter the partitions on the disk you added the new partition to.
  541. This, however, would force you to re-create and restore filesystems on the
  542. partition(s) you borrowed space from.  For my time and money, it was
  543. easier (and less error-prone) to add the swap partition by reloading
  544. the Foundation disks.  True Blue Gurus (TM) can experiment with the
  545. second method.
  546.  
  547. Comments and criticisms welcome.
  548.  
  549. Jeffrey L. Bromberger ------- System Manager ------- Tramway Unix Systems
  550. jeffrey@squid.tram.com      Anywhere!{van-bc,limbic,icus}!tram!jeffrey
  551.  
  552. ------------------------------------------------------------------------------
  553. Subject:  3 How can I get X11 for the 3B2?
  554. ------------------------------------------------------------------------------
  555.  
  556. From: aj4640@dean1.usma.edu  Robertson John MAJ at US Military Academy, West
  557. Point, N
  558.  
  559. [Read the P.S. at the end of this message before attempting to
  560.  ftp these files.]
  561.  
  562. The X11 R4 distribution tape contains sources to run clients on a 3b1.
  563. Several of us have hacked those sources to enable clients to run on a
  564. 3b2.
  565.  
  566. I wish I could offer the source patches directly but for various
  567. reasons, I can't.  However, 3b2 users are more than welcome to have the
  568. clients, the libraries, the include files, and the pre-processor.  This
  569. will get X-windows up on your 3b2 without the xdaemon stuff (as long as
  570. you have the Wollongong networking stuff.)  With this stuff, you'll
  571. have a pile of ready-to-run clients as well as the tools needed to
  572. compile your own X11 applications.
  573.  
  574. In addition to the default X11 R4 clients, bin.tar.Z also has a running
  575. copy of tgif, xdvi, xmahjongg [you'll need to do the fonts for your
  576. server.  UTSL!], and lots of other neat stuff.
  577.  
  578. The lib.tar.Z contains libX11.a, libXt.a, etc.  In addition, the
  579. app-defaults for all the clients in bin.tar.Z are also here.
  580.  
  581. include.tar.Z has all the include files.  You'll need these if you want
  582. to compile your own stuff.
  583.  
  584. cpp.tar.Z is a compiled version of the X11 distribution preprocessor.
  585. In this version, you'll need to define the symbol 3b2 before
  586. invocation.  It will not gag on the big header files that many X
  587. applications use.
  588.  
  589. The files can be obtained via anonymous ftp from euler.math.usma.edu.
  590. They are in pub/3b2.  Other than unpaccking and installing the clients
  591. and lib stuff in the usual places, no other special work should be
  592. needed.
  593.  
  594. I cannot offer any support for this stuff.  Take it, hack it, and have
  595. fun.  Even more, give the clients away to other suffering 3b2 users.
  596. It has made our 3b2's substantially easier to use.
  597.  
  598. Jack
  599.  
  600. P.S.  The X11R4 clients for the 3B2 have been moved to Bradley University
  601.       on erratic.bradley.edu in pub/3B2_X.  If that system is down, you
  602.       may want to also try ds3.bradley.edu, also in pub/3B2_X.
  603.  
  604. ------------------------------------------------------------------------------
  605. Subject:  4 How do I install a non AT&T SCSI drive on my 3B2?
  606. ------------------------------------------------------------------------------
  607.  
  608. From: geoff@ugc.uucp (Geoff Coleman)
  609.  
  610. Installation of Third Party SCSI drive on AT&T 3B2
  611.  
  612. 1.  Hardware Addition
  613. The hardware installation is relatively simple. The SCSI address of the
  614. disk must be set via jumpers. If the disk being added is the first
  615. outside disk for the 3B2 then the you must use an "AT&T SCSI Connect
  616. Kit".
  617.  
  618. 2.  Telling the system about the disk
  619. After the disk has been physically attached the machine should be
  620. restarted.  If the disk is one that is unknown to the 3B2 a message
  621. will appear on the console that there is an unknown scsi device "make"
  622. "model". The make and model information is important.
  623.  
  624. Once the 3b2 is rebooted login as root and cd to /etc/scsi.  At this
  625. point you should run ./edittbl -l to list all of the SCSI devices known
  626. to the system. Then run device table. The first entry is the make and
  627. must be padded with spaces to 8 characters.  The second entry is the
  628. model and must be padded to 16 characters with spaces.  The number of
  629. lu's is one unless it is a bridge controller.
  630.  
  631. At this point you should reboot the machine and there should be no
  632. unknown device error message on bootup.
  633.  
  634. 3.  Formatting the disk
  635. Once the system has been rebooted login as root and change the run
  636. level to single user mode and remount /usr if need be.
  637.  
  638. At this point you need to cd to /usr/lib/scsi and edit the file
  639. tc.index.  Add an entry for the new disk in the same manner as the
  640. other entries in this file. Make sure that the model number starts in
  641. column 9 and is padded out to 16 characters, if you receive an unable
  642. to open script file message on formatting the problem is most likely in
  643. this entry.
  644.  
  645. At this point you can run the format program from either sysadm or the
  646. command line. After the format has finished reboot the system and the
  647. disk should be listed as a formatted disk.
  648.  
  649. ------------------------------------------------------------------------------
  650. Subject:  5 How do I prevent data overrun errors when using a high
  651.             speed modem on an EPORTS card at 19.2K baud or higher?
  652. ------------------------------------------------------------------------------
  653.  
  654. The EPORTS board can easily handle 38.4K baud on an otherwise
  655. unloaded system, provided Hardware Flow Control is enabled.  The
  656. hard part is keeping HFC enabled.  Several solutions to this problem
  657. exist, but one that seems to work (and I use personally) is to have
  658. a daemon set HFC on open lines periodically, and have uugetty enable
  659. HFC on all logins.
  660.  
  661. The second part is the trickier part.  Elliot Dierksen suggests
  662. the following, which I have verified to work:
  663.  
  664. From: ebd@fang.att.com (Elliot B Dierksen)
  665.  
  666. Step 1: copy uugetty to some new name (I used epuugetty). Use some
  667. sort of binary editor to change the exec of '/bin/login' to '/bin/ephfc'.
  668.  
  669. Step 2: compile ephfc. Here it is!
  670.  
  671. I have had no problems with this at all, but your mileage may vary.
  672. No promises implied or intended. Even with cron entries to set HFC,
  673. I still have problems on occasion with dial outs. Inbound calls
  674. work great.
  675.  
  676. I hope you all find this useful!
  677.  
  678. ----------------cut here--------------------------------------
  679. /* ephfc.c
  680.  
  681. handle hardware flow control on EPORTS and then exec login
  682.  
  683. This program sets hardware flow control on an EPORTS card in an
  684. AT&T 3B2 computer. Patch getty (or uugetty) to exec ephfc instead of login.
  685.  
  686. 04/18/1992 - Elliot Dierksen (e.dierksen@att.com, elliot@alfred.oau.org)
  687.  
  688. */
  689.  
  690. /* standard header files */
  691. #include <stdio.h>
  692. #include <fcntl.h>
  693. #include <errno.h>
  694. #include <sys/ct_dep.h>
  695. #include <termio.h>
  696.  
  697. /* EPORTS header files */
  698. #include <sys/queue.h>
  699. /*#include <sys/ep_dep.h>*/
  700. #include <sys/eppc.h>
  701. #include <sys/ep_lla.h>
  702.  
  703. #define IN_FD   0
  704. #define OUT_FD  1
  705.  
  706. main(argc,argv,envp)
  707. int argc;
  708. char **argv,**envp;
  709. {
  710. char *login_prog = "/bin/login";
  711. struct etty ettyp;
  712. struct termio termiop;
  713.  
  714.     /* abort if ioctl read fails. this might happen this is not an EPORT */
  715.     if (ioctl(IN_FD,EP_GETA,&ettyp) == -1)
  716.     {
  717.         fprintf(stderr,"%s: ioctl(EP_GETA) failed(%d)\n",argv[0],errno);
  718.         fflush(stderr);
  719.         exit(6);
  720.     }
  721.  
  722.     /* abort if ioctl read fails. No clue what might have gone wrong! */
  723.     if (ioctl(IN_FD,TCGETA,&termiop) == -1)
  724.     {
  725.         fprintf(stderr,"%s: ioctl(TCGETA) failed(%d)\n",argv[0],errno);
  726.         fflush(stderr);
  727.         exit(7);
  728.     }
  729.  
  730.     /* turn off XON/XOFF */
  731.     termiop.c_iflag &= ~(IXON|IXOFF|IXANY);
  732.  
  733.     /* set regular ioctl values */
  734.     ioctl(OUT_FD,TCSETA,&termiop);
  735.  
  736.     /* set EPORTS values */
  737.     ioctl(OUT_FD,EP_HFC,0);
  738.  
  739.     /* reset arg[0] for login */
  740.     argv[0] = login_prog;
  741.  
  742.     /* exec login and hope for the best! */
  743.     execv(login_prog,argv);
  744. }
  745.  
  746. ------------------------------------------------------------------------------
  747. Subject:  6 What does the 'NOTICE: File Table Overflow' error mean?
  748. ------------------------------------------------------------------------------
  749.  
  750. From: v.hoang@att.com
  751.  
  752. It means more files being opened than the limit you've set for the
  753. system.  Edit /etc/master.d/kernel and bump up the values of NFILE,
  754. NINODE & NS5INODE (or something close to that), then cd /boot,
  755. mkboot -k KERNEL, touch /etc/system then reboot the system.
  756.  
  757. ------------------------------------------------------------------------------
  758. Subject:  7 How do I set up anonymous ftp?
  759. ------------------------------------------------------------------------------
  760.  
  761. From: rdc30@nmrdc1.nmrdc.nnmc.navy.mil (LCDR Michael E. Dobson)
  762. Subject: Anonymous ftp with WIN/TCP 3.0.x YES!!
  763.  
  764. Contrary to the documentation for WIN/TCP 3.0.{0,1}, it is possible to
  765. set up anonymous ftp.  The Bugs: note in the documentation about it not
  766. being fully implemented in this release seems to be just a
  767. documentation ommision.  I saw the method to use on a US military 3B2
  768. Users Group mailing list.  The missing parts are the creation of a dev
  769. directory in the root of the ftp account directory with null and tcp
  770. devices created with mknod, and the inclusion of the services file in
  771. the etc subdir along with group and passwd files.  You of course need
  772. ls & pwd in bin and a pub tree.  Below is the output of ls -lR in my
  773. ftp root as well as the passwd in ~ftp/etc/passwd.  Try it out and
  774. see.
  775.  
  776. total 5
  777. drwxr-xr-x   2 root     other         64 Jan 23 11:12 bin
  778. drwxr-xr-x   2 root     other         64 Jan 23 11:09 dev
  779. drwxr-xr-x   2 root     other         80 Jan 23 11:13 etc
  780. drwxr-xr-x   2 ftp      sys          240 Jan 23 11:16 pub
  781. drwxr-xr-x   2 root     other         64 Aug 28 20:01 shlib
  782.  
  783. /usr3/ftp/bin:
  784. total 111
  785. ---x--x--x   1 root     other      35678 Jan 23 11:11 ls
  786. ---x--x--x   1 root     other      19551 Jan 23 11:11 pwd
  787.  
  788. /usr3/ftp/dev:
  789. total 0
  790. crw-rw-rw-   1 root     sys       63, 43 Aug 28 19:57 circ
  791. crw-rw-rw-   1 root     sys       49,  2 Jan 23 11:09 null
  792. crw-rw-rw-   1 root     sys       63, 38 Jan 23 11:09 tcp
  793. crw-rw-rw-   1 root     sys       63, 36 Aug 28 19:56 udp
  794.  
  795. /usr3/ftp/etc:
  796. total 4
  797. -r--r--r--   1 root     other        336 Jan 23 11:12 group
  798. -r--r--r--   1 root     other         56 Jan 23 11:13 passwd
  799. -r--r--r--   1 root     other        884 Jan 23 11:12 services
  800.  
  801. /usr3/ftp/pub:
  802. total 0
  803.  
  804. /usr2/ftp/shlib:
  805. total 211
  806. -r-xr-xr-x   1 root     other      66626 Aug 28 20:01 libc_s
  807. -r-xr-xr-x   1 root     other      39859 Aug 28 20:01 libnsl_s
  808.  
  809. Contents of ~/ftp/etc/passwd:
  810.  
  811. ftp:x:13:1:Anonymous FTP Account:/usr3/ftp:/usr/bin/ftp
  812.  
  813. --
  814. Mike Dobson, Sys Admin for      | Internet: rdc30@nmrdc1.nmrdc.nnmc.navy.mil
  815. nmrdc1.nmrdc.nnmc.navy.mil      | UUCP:   ...uunet!mimsy!nmrdc1!rdc30
  816. AT&T 3B2/600G Sys V R 3.2.2     | BITNET:   dobson@usuhsb or nrd0mxd@vmnmdsc
  817. WIN/TCP for 3B2                 | MCI-Mail: 377-2719 or 0003772719@mcimail.com
  818.  
  819. A special note from Steven M. Kilby <skilby@ucqais.cba.uc.edu>
  820.  
  821. Anonymous FTP for the 400:
  822.     Setting up an anonymous FTP login for the 3B2/400 differs slightly from
  823. the instructions in the FAQ.  The FAQ instructions will work on 600's or
  824. 1000's.  The only changes are in the directory setup.
  825.  
  826. [As other people found the original anonymous FTP setup did not
  827.  work at all without Steven M. Kilby's changes, I modified the
  828.  directory structure above to reflect Steve's changes.  -greg]
  829.  
  830. Also:
  831. From: Kevin Darcy <kevin@cfctech.cfc.com>
  832.  
  833. Also, you should probably make people aware that the exact minor
  834. numbers for all clone devices will vary from system to system, and
  835. to only use the ones displayed as a guide. For instance, my dev
  836. entries for circ, tcp & udp are
  837.  
  838. crw-rw-rw-   1 root     other     63, 66 Sep 10  1991 /dev/circ
  839. crw-rw-rw-   1 root     other     63, 56 Sep 10  1991 /dev/tcp
  840. crw-rw-rw-   1 root     other     63, 58 Sep 10  1991 /dev/udp
  841.  
  842. which is somewhat different than what's shown above (cfctech's
  843. major numbers are higher than most folks', because we have run
  844. StarLAN, Datakit & WIN/TCP all simultaneously on the machine, in
  845. addition to everything on the release tape, and, at one point, even
  846. loaded X Windows on the box (!)).
  847.  
  848. ------------------------------------------------------------------------------
  849. Subject:  8 Is there a reposity of ftp-able 3B2 programs?
  850. ------------------------------------------------------------------------------
  851.  
  852. The following are some 3B2 ftp sites that I know of and what they
  853. contain:
  854.  
  855. ames.arc.nasa.gov (128.102.18.3)
  856.     Kyoto-Lisp, Pascal, Sendmail, citadel-bbs
  857.  
  858. ds3.bradley.edu (136.176.5.79)
  859.     X11R4, old gcc
  860.  
  861. erratic.bradley.edu (136.176.5.253)
  862.     X11R4, old gcc
  863.  
  864. stasi.bradley.edu (136.176.5.121)
  865.     xarchie, lpr/lpd
  866.  
  867. And then there's...
  868.  
  869. From: Jeffrey A. Thompson <jeffrey@rigel.econ.uga.edu>
  870.  
  871. Here is a list of software I have compiled on my 3b2 (roscoe.msit.uga.edu)
  872. available via anonymous ftp. I have all the source too.
  873.  
  874. 287172 Nov 19 13:37 bash*          GNU's Bourne Again Shell
  875.  35137 Apr  5  1990 compress*      
  876.   5959 Aug 22 20:55 culimit*       Program to change the ulimit of a shell to
  877.                                    10 megabytes instead of 1 megabyte. 
  878.  48615 Jan 25 11:10 gab*           My own little talk program for up to 19 
  879.                        people ; uses shared memory and semaphores
  880. 174992 Aug 23  1990 kermit*        The standard kermit.
  881.  60393 May 19  1990 rb*            X/Y/Z modem
  882.  60393 May 19  1990 rx*
  883.  60393 May 19  1990 rz*
  884.  59254 May 19  1990 sb*
  885.  32546 Nov  6 08:17 ship*          Zip's ship 
  886.  59254 May 19  1990 sx*
  887.  59254 May 19  1990 sz*
  888.  35137 Apr  5  1990 uncompress*
  889.  61743 Nov  6 08:17 unzip*         Unzip ; I love zip. It works on everything.
  890.                    and better compression than compress 
  891.                                    (average 10 to 30 percent better 
  892.                                    compression)
  893.  38784 Jun 22  1991 uudecode*
  894.  23781 Jun 22  1991 uuencode*
  895.  20844 Sep  7 17:51 uvapc*         A standard pascal compiler
  896.  35137 Apr  5  1990 zcat*          
  897.  75420 Nov  6 08:15 zip*           Can produce pkzip compatible zips (-k opt)
  898.  35188 Nov  6 08:15 zipnote*
  899.  36904 Nov  6 08:15 zipsplit*      Splits up a zip file into smaller zip files
  900.                                    Great for copying stuff onto a floppy disk.
  901.  
  902. --jat
  903.  
  904. And then there's...
  905.  
  906. From: Steven M. Kilby <kilby@ucqais.cba.uc.edu>
  907.  
  908.     Starting October 1 ucqais.cba.uc.edu will offer an anonymous login service
  909. specifically for 3B2 users.  The anonymous login will contain software
  910. packages that have been ported to the 3B2, such as gcc, iscreen, lpr, X11,
  911. and many more!  Most of the offerings will be binary, although I will include
  912. as many sources as I can.  If there are any packages you would like to see
  913. available there, let me know!
  914.  
  915.  
  916. ------------------------------------------------------------------------------
  917. Subject:  9 How do I run Unix from floppy (for example, to repair a damage
  918.         hard drive file system)?
  919. ------------------------------------------------------------------------------
  920.  
  921.                Running a Standalone Shell on a 3B2
  922.  
  923.                         Stephen J. Friedl
  924.                     [Edited by Gregory Gulik]
  925.  
  926.                          April 25, 1988
  927.  
  928.           NB:  the   procedures   described   here
  929.           require  substantial  knowledge  of  UNIX and
  930.           entail a significant risk of causing loss  of
  931.           data.  The obvious disclaimers apply here, so
  932.           use at your own risk.  Please be careful.
  933.  
  934. Introduction
  935.  
  936.      This document is an introduction to operating your 3B from a
  937. standalone /unix.  Even with inoperable hard drives, it is possible to
  938. insert the boot floppy (Essential Utilities Disk 1), say some magic
  939. words, and receive a # prompt.  At this point you can do major surgery
  940. on the failing machine, often recovering a drive previously thought to
  941. be lost.
  942.  
  943.      Our style is informal and we'll use lots of examples to illustrate
  944. the points at hand.  We have been using standalone shells for quite
  945. some time and have learned a great deal; we hope to pass this
  946. information on to you.  Please read this document carefully before
  947. trying the methods described here, and if possible have a wizard around
  948. when giving it a go.  This can be dangerous business: as has been said
  949. before, it is a time where experience and informed courage count for
  950. much.
  951.  
  952. Conventions
  953.  
  954.      Throughout this document, sample usage sessions will be shown
  955. indented, with user input in bold.  To make it easier to distinguish
  956. between a multiuser UNIX shell and a standalone one, we will show
  957. multiuser UNIX's root prompt as ## and the standalone prompt as #.
  958.  
  959.  
  960. >>> Back up your boot disks b->
  961.  
  962.      This cannot be emphasized enough.  Your boot floppies are the key
  963. to your machine, and without them the machine is down.
  964.  
  965. Why do you want a standalone /unix?
  966.  
  967.      The most compelling reason for a standalone shell is when the
  968. primary drive has gone down and must be recovered.  While working from
  969. a standalone /unix is slow and tedious, it can often save an entire
  970. hard disk with minimal data loss.
  971.  
  972.      We have also used this standalone shell to repair a corrupt
  973. /etc/inittab, to fix /etc/passwd, to restore a /bin/login that had been
  974. removed, and to install new bootstraps on the hard drive.  With a
  975. standalone boot disk in hand, a host of possibilities presents itself.
  976.  
  977.  
  978. What is on your boot disk?
  979.  
  980.      Before booting this floppy, take some time to explore its
  981. contents, as the disk has a filesystem on it that can be mounted and
  982. perused.  To do this, insert a COPY of the Essential Utilities Floppy 1
  983. (from now on, "the boot floppy") into the drive with a write-protect
  984. tab.  Now,
  985.  
  986.           ## mount /dev/dsk/c0d0s5 /install -r
  987.  
  988.      Because boot floppies vary from release to release, it would be
  989. most helpful to simply get a listing of the contents of your particular
  990. boot floppy.
  991.  
  992.      Once finished, the floppy must be unmounted:
  993.  
  994.           ## cd /
  995.           ## umount /dev/dsk/c0d0s5
  996.  
  997. "Open Sesame"
  998.  
  999.      To give standalone a try, first shut the machine down to firmware
  1000. mode.  Assuming the machine is now in firmware mode, put a copy of the
  1001. boot disk into the drive.  Note that some versions of the operating
  1002. system (Sys V Release 2, at least) require that the boot floppy be
  1003. write-enabled (i.e., no write-protect tab); it is this requirement that
  1004. mandates multiple backups of the boot floppy.  UNIX will be updating
  1005. the disk while it runs -- the superblock, access times, etc. -- and if
  1006. the machine crashes at the wrong time it simply will not boot again
  1007. without an fsck.  Be careful.
  1008.  
  1009.      Type in your firmware password and boot /unix from the floppy
  1010. drive (Option 0, named `FD5') instead of the hard drive (Option 1,
  1011. named `HD30' or `HD72').  It can take several minutes for UNIX to boot,
  1012. but when it does, the familiar menu will be displayed:
  1013.  
  1014.                1) Full Restore
  1015.                2) Partial Restore
  1016.                3) Dual-Disk Upgrade
  1017.                4) Release Upgrade
  1018.                Selection? [1, 2, 3, 4, quit, help]
  1019.  
  1020.      At this point, type the phrase
  1021.  
  1022.                            magic mode
  1023.  
  1024.      The system recognizes this special option and responds:
  1025.  
  1026.           Poof!
  1027.  
  1028.           Selection? [1, 2, 3, 4, quit, help, shell, copy]
  1029.  
  1030.      Notice the new options?  Now type shell, then RETURN, and you will
  1031. be greeted with the familiar # prompt.  You are now running a
  1032. standalone shell on the floppy.
  1033.  
  1034.      A few reminders here: a floppy filesystem is not able to hold much
  1035. data, and many common utilities are unavailable.  When dealing with the
  1036. standalone shell, one must learn alternatives to these utilities.  For
  1037. example, echo * can replace ls(1), and cat > file can serve as a poor
  1038. replacement to ed(1).  One must become remarkably resourceful when
  1039. working in an environment as restricted as this.  We will see later how
  1040. we can enhance this confined environment with additional tools.
  1041.  
  1042. Standalone devices
  1043.  
  1044.      The floppy's /dev directory contains a host of entries, some of
  1045. them referring to partitions on the hard drive.  While a particular
  1046. partition may have several names, we generally use the following
  1047. devices to refer to the hard disk:
  1048.  
  1049.           Partition        What it is (on the hard disk)
  1050.           -----------      -----------------------------
  1051.           /dev/idsk00      / filesystem
  1052.           /dev/idsk01      swap area
  1053.           /dev/idsk02      /usr filesystem
  1054.           /dev/idsk06      the entire disk
  1055.           /dev/idsk07      boot partition
  1056.           /dev/idsk08      optional filesystem (/u or /usr2)
  1057.  
  1058. Mounting the hard drive
  1059.  
  1060.      To gain access to the primary hard drive, partitions of interest
  1061. are mounted onto directories on the floppy.  The device names are
  1062. selected from the table in the previous section.
  1063.  
  1064.      Before mounting a partition, we recommend running the filesystem
  1065. check fsck(1m) first.  The mount command will fail if the the
  1066. superblock is not in order -- this is often the case after a crash.  In
  1067. addition, it gives a convenient verification of the device status and
  1068. the the filesystem's name and volume.
  1069.  
  1070.           # /etc/fsck /dev/idsk00
  1071.  
  1072.      While some errors are to be expected while checking the root
  1073. partition, a total failure is a very serious error.  Our experience
  1074. defines "total failure" as an indication by fsck that it cannot find
  1075. any possible traces of a filesystem.  In particular, "CAN NOT READ: BLK
  1076. 1" is one of the more ominous messages we have seen.
  1077.  
  1078.      Once fsck grants the filesystem a clean bill of health, it is
  1079. ready to be mounted.  Rather than take up space for a handful of common
  1080. commands, AT&T has rolled several of them into one:  fsys.  It is
  1081. undocumented and appears to only be used on the boot floppy.  Some
  1082. versions of the boot disk do contain the mount and umount programs and
  1083. those can be used instead of fsys.
  1084.  
  1085.      Fsys takes a handful of options, not all of which are interesting
  1086. to us in standalone mode.  Used in the install scripts for a handful of
  1087. filesystem-related duties, we will use it simply as a replacement for
  1088. mount(1m) and umount(1m).  To mount the hard disk's root filesystem
  1089. onto the floppy's /install directory, do:
  1090.  
  1091.           # fsys -m /install /dev/idsk00
  1092.  
  1093.      Fsys will complain on an error, and this brings us to a serious
  1094. bug in this program: if either the mount directory or the partition's
  1095. device name are invalid for any reason, the error message will always
  1096. point to the partition device name.  This can be, to put it lightly,
  1097. "misleading".
  1098.  
  1099.      With the hard drive's root filesystem mounted on /install, it is
  1100. now fully part of the standard directory tree.  While the floppy has no
  1101. editor or many of the helpful tools, the root partition does, and these
  1102. can be exploited.  When beginning an extended standalone session on the
  1103. primary drive, we have found it helpful to extend the shell's search
  1104. path:
  1105.  
  1106.           # PATH=/install/bin:/install/etc:$PATH ; export PATH
  1107.  
  1108.      Now the familiar ls, ed, (but not vi) and many other commands are
  1109. available.  Since they will be loaded from the hard drive, execution is
  1110. much faster.
  1111.  
  1112.      As an example, assume that the root password has been forgotten
  1113. and the machine is basically closed.  The solution suggested by AT&T's
  1114. documentation (in the System Administration Utilities Guide) is to do a
  1115. partial restore.  The difficulty with this approach is that many
  1116. important system files -- /etc/passwd, /etc/inittab, /etc/gettydefs,
  1117. and others -- are overwritten in the process.  Even with a full backup,
  1118. this can be an unpleasant undertaking.
  1119.  
  1120.      An alternate approach will use the standalone shell.  The general
  1121. strategy is to mount the hard drive, edit the password file, and boot
  1122. multiuser UNIX.  The full procedure is:
  1123.  
  1124.           (boot standalone /unix)
  1125.           # fsck /dev/idsk00
  1126.           # fsys -m /install /dev/idsk00
  1127.           # /install/bin/ed /install/etc/passwd
  1128.           (edit the file in the standard way)
  1129.           w
  1130.           q
  1131.           # fsys -u /dev/idsk00
  1132.  
  1133.      At this point, the root drive is now unmounted and the system may
  1134. be rebooted.  Normally you can just type exit at the shell prompt and
  1135. you will be returned to the monitor and asked what program to boot.  If
  1136. that doesn't work on your version, try:
  1137.  
  1138.           # sync
  1139.           # sync
  1140.           # /etc/uadmin 2 2
  1141.  
  1142.      Uadmin(1m) is documented in the manual (you must also refer to the
  1143. uadmin(2) manual page) -- the above does a normal return to the monitor
  1144. (i.e., firmware).  WARNING: uadmin(1m) is available from full UNIX as
  1145. well but is very dangerous.  Use it with extreme caution and only if
  1146. you really know what uadmin does.
  1147.  
  1148. Making a standalone boot disk
  1149.  
  1150.           ================== WARNING ==================
  1151.           Only do this on backup copies of  the  disks,
  1152.           NEVER to the main Essential Utilities Disk.
  1153.           ================== WARNING ==================
  1154.  
  1155.      The Essential Utilities Disk 1 contains many files needed by the
  1156. automatic restore/upgrade procedures, but for standalone work, many are
  1157. not needed.  After working with these disk for some time, we were able
  1158. to narrow down what is helpful to have on the disk and what is not.
  1159. The following procedure (run from multiuser mode, signified by the ##
  1160. prompt) will convert an Essential Utilities disk to a standalone boot
  1161. disk.
  1162.  
  1163.           (from hard disk UNIX)
  1164.           ## fsck /dev/dsk/c0d0s5
  1165.           ## mount /dev/dsk/c0d0s5 /install
  1166.           ## cd /install/inst/bin
  1167.           ## mv fsys pdinfo swap ttyset ../../bin
  1168.           ## cd /install
  1169.           ## /bin/rm -rf inst
  1170.           ## cp /bin/ed /install/bin
  1171.           ## cp /etc/fsdb /install/etc
  1172.           ## cat > /install/inittab
  1173.           is:s:initdefault:
  1174.           sh:s:respawn:/bin/sh < /dev/console > /dev/console 2>&1
  1175.           ^D
  1176.           ## cd /
  1177.           ## umount /dev/dsk/c0d0s5
  1178.  
  1179.      While there may be other files on this floppy that are not needed,
  1180. we have operated on the principle of least customization.  It has been
  1181. our experience that keeping the procedure simple allows it to be done
  1182. on-the-fly (say, at a customer site) and minimizes the exploration
  1183. required when a new operating system disk is released.
  1184.  
  1185.      In addition, it is not wise to pack the disk too tightly.  The
  1186. editor requires adequate space under /tmp, so an almost-full disk
  1187. precludes editing all but the smallest files; this applies whether the
  1188. file being edited resides on the hard drive or the floppy.
  1189.  
  1190.      Once this is done, the new disk will come up in standalone mode
  1191. without the need for magic mode.  In addition ed(1) and fsdb(1m) are
  1192. available.  The other tools mentioned (pdinfo, swap, ttyset) are
  1193. helpful but not required by the basic procedures.
  1194.  
  1195.      It has been our experience that any version (SVR2, SVR3) of boot
  1196. disk can be used with any version of hard disk UNIX without difficulty
  1197. for doing simple operations such a performing filesystem checks or
  1198. editing /etc/passwd.  For more complex operations, such as
  1199. repartitioning the hard drive or restoring the bootstraps, higher
  1200. version compatibility is required.
  1201.  
  1202. Security Considerations
  1203.  
  1204.      It should be apparent that knowledge of these standalone methods
  1205. is tremendously powerful.  In addition to being able to rescue a
  1206. foundering machine, an unrestricted path to root has been provided as
  1207. well.  While all the standard rules about physical security of the
  1208. computer apply here, an additional step may be taken to thwart a
  1209. would-be interloper.
  1210.  
  1211.      The responsible system administrator of a machine in a hostile
  1212. environment will generally change the computer's firmware password.
  1213. This magic word is required before the monitor on the 3B2 motherboard
  1214. will boot from a floppy, and lack of this password prevents a malicious
  1215. user from simply pulling the power plug to enter firmware mode.
  1216.  
  1217.      In addition to changing the firmware password, the floppy key
  1218. floppy should itself be secured.  When the computer is restarted with
  1219. this disk in the drive, it will clear the non-volatile RAM (NVRAM) and
  1220. restore the default parameters.  Because the firmware password is
  1221. included in these "default parameters", this disk should be kept out of
  1222. non-trusted hands.
  1223.  
  1224. Conclusion
  1225.  
  1226.      We solicit bug reports, comments, and suggestions on this
  1227. document.  Please direct them to:
  1228.  
  1229.     Stephen J. Friedl
  1230.     Software Consultant
  1231.     1891 Running Branch Way
  1232.     Tustin, CA 92680
  1233.     +1 714 544-6561 voice
  1234.     +1 714 838-0099 fax
  1235.  
  1236.     Internet:    friedl@mtndew.Tustin.CA.US
  1237.     Usenet:        {backbones}!uunet!mtndew!friedl
  1238.  
  1239. ------------------------------------------------------------------------------
  1240. Subject: 10 What is/was the 3B Journal?
  1241. ------------------------------------------------------------------------------
  1242.  
  1243.     The _3B Journal_ was put out sporadically by Owens-Laing
  1244.     Publications for several years in the late 1980s, and I used to be
  1245.     the technical editor.  The magazine dealt with the 3B1 and 3B2
  1246.     platforms, and the content varied from very markety-oriented to
  1247.     quite technical (the latter usually written by me).
  1248.  
  1249.     The publisher never seemed to get a handle on the business end of
  1250.     running a magazine, and I've heard nothing past the fourth quarter,
  1251.     1989 issue.  The current phones are disconnected, and I have NO
  1252.     information on subscriptions or anything like that.
  1253.  
  1254.          -- Stephen Friedl  friedl@mtndew.Tustin.CA.US   3/12/1992
  1255.  
  1256. ------------------------------------------------------------------------------
  1257. Subject: 11 What are the various models of 3B2s and their differences?
  1258. ------------------------------------------------------------------------------
  1259.  
  1260. [I'm putting this together mostly from memory and from discussions
  1261.  with other people.  Please feel free to make corrections.]
  1262.  
  1263. Some corrections/aditions provided by Andrew D. Hay <adh@petrel.att.com>,
  1264. Paul S. Sawyer <paul@unhtel.unh.edu>, Mike Crom <crom@vogon.att.com>,
  1265. David Beneman <..!uunet!tacoma!dcb>, Paul Rak <pjr@emo.com>
  1266.  
  1267. The 3B2 family of consists of the following models:
  1268.  
  1269. 3B2/300
  1270.  
  1271.     Processor:
  1272.         WE32000, 8 MHz
  1273.         almost 1 MIPS
  1274.  
  1275.     Memory:        
  1276.         Supports a maximum of 4 MB of RAM using two half height
  1277.         2 MB memory cards.
  1278.  
  1279.     Slots:
  1280.         4 standard slots.
  1281.  
  1282.     Features:
  1283.         MFM disk controller on motherboard
  1284.         1 internal full-height drive bay
  1285.         1 720 K floppy drive
  1286.  
  1287. 3B2/310
  1288.  
  1289.     Processor:
  1290.         WE32100, 10MHz (supports optional MAU)
  1291.         1.1 MIPS
  1292.  
  1293.     Memory:
  1294.         Supports a maximum of 4 MB of RAM using two half height
  1295.         2 MB memory cards.
  1296.  
  1297.     Slots:
  1298.         4 standard slots.
  1299.  
  1300.     Features:
  1301.         MFM disk controller on motherboard
  1302.         1 internal full-height drive bay
  1303.         1 720 K floppy drive
  1304.  
  1305. 3B2/400
  1306.  
  1307.     Processor:
  1308.         WE32100, 10MHz (supports optional MAU)
  1309.         1.1 MIPS
  1310.  
  1311.     Memory:
  1312.         Supports a maximum of 4 MB of RAM using either two half
  1313.         height or full height 2 MB memory cards.
  1314.  
  1315.     Slots:
  1316.         12 standard slots.
  1317.  
  1318.     Features:
  1319.         MFM disk controller on motherboard
  1320.         2 internal full-height drive bays
  1321.         1 720 K floppy drive
  1322.         1 23 MB cartridge tape drive
  1323.  
  1324. 3B2/500
  1325.  
  1326.     Processor:
  1327.         WE32100, 18MHz
  1328.         2.1 MIPS
  1329.         2.6 MIPS w/VCache
  1330.         4.0 MIPS w/MPE
  1331.  
  1332.     Memory:
  1333.         2 - 4MB cards max
  1334.  
  1335.     Slots:
  1336.         7 I/O + 4 system (MEM0, MEM1, Vcache, BUB0)
  1337.         There is also BUB1, but it is listed as unusable
  1338.         without the 22MHz upgrade.
  1339.  
  1340.     Features:
  1341.         SCSI disks
  1342.         Up to 1 additional MPE
  1343.  
  1344. 3B2/522
  1345.  
  1346.     Processor:
  1347.         WE32200, 22MHz
  1348.         5.0 MIPS
  1349.  
  1350.     Memory:
  1351.         2 - 16MB cards max
  1352.  
  1353.     Slots:
  1354.         7 I/O + 4 system (MEM0, MEM1, Vcache, BUB0, BUB1)
  1355.  
  1356.     Features:
  1357.         SCSI disks
  1358.         Field upgraded 3B2/500 to same processor as 3B2/700
  1359.         Up to 1 additional MPE
  1360.  
  1361. 3B2/600 (aka 3B2/1000-60)
  1362.  
  1363.     Processor:
  1364.         WE32100, 18MHz
  1365.         2.6 MIPS
  1366.         4.0 MIPS w/MPE
  1367.  
  1368.     Memory:
  1369.         4 - 4MB cards max
  1370.  
  1371.     Slots:
  1372.         12 I/O + 12 system
  1373.  
  1374.     Features:
  1375.         SCSI disks
  1376.         120MB SCSI tape
  1377.         Up to 3 additional MPEs
  1378.  
  1379. 3B2/700, 3B2/622 (aka 3B2/1000-70)
  1380.  
  1381.     Processor:
  1382.         WE32200, 22MHz
  1383.         4KB PCache
  1384.         5.0 MIPS
  1385.         7.5 MIPS w/1 MPE
  1386.         8.5 MIPS w/2 MPEs
  1387.         9.0 MIPS w/3 MPEs
  1388.  
  1389.     Memory:
  1390.         4 - 16MB cards max
  1391.  
  1392.     Slots:
  1393.         12 I/O + 12 system
  1394.  
  1395.     Features:
  1396.         SCSI disks
  1397.         120MB SCSI tape
  1398.         Up to 3 MPEs
  1399.         The 3B2/622 is a field upgrade for the 3B2/600
  1400.  
  1401. 3B2/1000, 3B2/600G (aka 3B2/1000-80)
  1402.  
  1403.     Processor:
  1404.         WE32200, 24MHz
  1405.         9 MIPS
  1406.         16 MIPS w/3 MPEs
  1407.  
  1408.     Memory:
  1409.         4 - 16MB cards max
  1410.  
  1411.     Slots:
  1412.         12 I/O + 12 system
  1413.  
  1414.     Features:
  1415.         SCSI disks
  1416.         Up to 3 MPEs
  1417.  
  1418. 3B2/1050 R3
  1419.  
  1420.     Processor:
  1421.         MIPS R3000A, 33MHz
  1422.  
  1423.     Memory:
  1424.         16MB - 32MB
  1425.  
  1426.     Slots:
  1427.         N/A
  1428.  
  1429.     Features:
  1430.         N/A
  1431.  
  1432. 3B2/1100 R3
  1433.  
  1434.     Processor:
  1435.         MIPS R3000A, 33MHz
  1436.  
  1437.     Memory:
  1438.         32MB - 64MB
  1439.  
  1440.     Slots:
  1441.         N/A
  1442.  
  1443.     Fetures:
  1444.         N/A
  1445.  
  1446. 3B15
  1447.  
  1448.     Processor:
  1449.         WE32100 (standard MAU) (?)
  1450.         2 MIPS (?)
  1451.  
  1452.     Memory:
  1453.         16 MB (?)
  1454.  
  1455.     Slots:
  1456.  
  1457.     Features:
  1458.         Standard 9-Track tape drive
  1459.         Uses 8 inch SCSI drives
  1460.  
  1461.         NOTE: Not all 3B15s have SCSI.  Some models were
  1462.         converted from 3B5s and have 8 inch FSD drives (maximum
  1463.         8, 160 MB or 340 MB).  Then there are the Lark II
  1464.         drives.  The non-SCSI tape bus can take 1-4 drives.
  1465.         The 3B5 becomes a 3B15 by a change of 2 (??) boards,
  1466.         and most importantly, a new name sticker!
  1467.  
  1468. 3B4000
  1469.  
  1470.     Processor:
  1471.         WE32100 from 3B15 as control processor
  1472.         1 or more 3B2/600's as attached processors
  1473.  
  1474.     Memory:
  1475.  
  1476.     Slots:
  1477.  
  1478.     Features:
  1479.         Supports tons of SCSI disk
  1480.  
  1481.  
  1482. 3B2 PERIPHERALS
  1483.  
  1484. Name    Device Code     Description
  1485. ----    -----------     -----------
  1486. SBD     0x0001          System motherboard
  1487. NI      0x0002          10base5 ethernet card
  1488. PORTS   0x0003          Ports card.  4 serial, 1 parallel. (includes HPP)
  1489. CTC     0x0005          Cartridge tape controller.  23 MB
  1490. NAU     0x0006          Network access unit.  1 MB STARLAN
  1491. SCSI    0x0100          SCSI host adapter
  1492. AIC     0x0101          Alarm interface circuit
  1493. EPORTS  0x0102          Extended ports.  8 serial ports
  1494. ISC     0x0201          Intelligent serial controller.  Bisync of X.25
  1495. XDC     0x0204          External disk controller for 2 more MFM drives
  1496. MAU     0xFD00          Math accelerator unit
  1497. VCACHE  0xFE00          Extended memory chache (3B2/600 and higher)
  1498. MPB     0xFF00          Multiprocessor board (3B2/600 and higher)
  1499.  
  1500. ------------------------------------------------------------------------------
  1501. Subject: 12 How do I build GCC on the 3B2?
  1502. ------------------------------------------------------------------------------
  1503.  
  1504. John L. Wehle ported GCC to the WE32000 series processor, and it
  1505. first appeared in release 2.2 of GCC.
  1506.  
  1507. To build the GCC release on the 3B2, download the latest GCC
  1508. distribution and allocate at least 35 MB of disk space to do the
  1509. build.  Follow the directions in the INSTALL file.  The following
  1510. are some notes that will make the install go smoother.
  1511.  
  1512. First of all, older versions of /lib/cpp are not capable of
  1513. processing one of the source files.  I recommend building the
  1514. distribution until the GNU cpp is done.  Then, temporarily replace
  1515. your /lib/cpp with the GNU version, and add the following flag to
  1516. CFLAGS:
  1517.  
  1518. CFLAGS = -U__STDC__
  1519.  
  1520. When stage1 is complete, you could remove the -U__STDC__ flag
  1521. and restore your original cpp.
  1522.  
  1523. Basically, the steps are as follows:
  1524.  
  1525.     $ configure --target=we32k-att-sysv3
  1526.     $ make LANGUAGES=c
  1527.     $ make stage1
  1528.     $ make LANGUAGES=c CC=stage1/gcc CFLAGS="-Bstage1/ -g"
  1529.  
  1530. [It is imporant to note that due to a bug in the AT&T compiler,
  1531.  the optimizer doesn't get compiled correctly at this point.]
  1532.  
  1533.     $ make stage2
  1534.     $ make CC=stage2/gcc CFLAGS="-Bstage2/ -g -O"
  1535.  
  1536. [Some people still have problems with the optimizer at this point.
  1537.  If you do, just do not use the -O flag when compiling GCC.  The
  1538.  symptom you will experience that tells you the -O flag should be
  1539.  removed is the compilation of cccp.c will take a VERY long time.
  1540.  Kill the compile and restart without the -O.]
  1541.  
  1542.     $ make stage3
  1543.     $ make CC=stage3/gcc CFLAGS="-Bstage3/ -g -O"
  1544.  
  1545. To verify everything built correctly:
  1546.  
  1547.     $ for file in *.o; do
  1548.     > tail +10c $file > foo1
  1549.     > tail +10c stage3/$file > foo2
  1550.     > cmp foo1 foo2 || echo $file
  1551.     > done
  1552.  
  1553. Then, to install the distribution:
  1554.  
  1555.     $ make CC=stage3/gcc CFLAGS="-Bstage3/ -g -O" install
  1556.  
  1557. Good luck!
  1558.  
  1559. [These notes are a combination of my own experiences with building the
  1560.  GCC compiler on a 3B2/400 and discussions with John Wehle, the author
  1561.  of the port.]
  1562.  
  1563. NOTES:
  1564.  
  1565. The GCC binaries available on several anonymous FTP sites will not
  1566. work with certain version of the standard C compiler.  It appears
  1567. to be some sort of linker problem.  I may have a fix for it.
  1568. Contact me via E-mail if you fall into this category.
  1569.  
  1570. Speaking of linker problems, GCC will not work all that well with
  1571. the standard C shared library -lc_s.  The workaround for this is
  1572. to compile your program with GCC, but the link will fail.  When it
  1573. does, use something like the following to do the link stage:
  1574.  
  1575. $ cc -O -L/usr/local/lib/gcc-lib/we32k-att-sysv/2.2.2 program.o \
  1576.     -o program -lgcc -lc_s
  1577.  
  1578. This way, you will not only get fast binaries, but small ones as
  1579. well.
  1580.  
  1581. You may need to raise your ULIMIT to compile the g++ compiler as
  1582. the executable is larger than 1 MB.
  1583.  
  1584. ------------------------------------------------------------------------------
  1585. Subject: 13 What is the NVRAM SANITY FAILURE?
  1586. ------------------------------------------------------------------------------
  1587.  
  1588. The full error message resembles the following:
  1589.  
  1590. FW ERROR 1-01: NVRAM SANITY FAILURE
  1591.                DEFAULT VALUES ASSUMED
  1592.                IF REPEATED, CHECK THE BATTERY
  1593.  
  1594. The 3B2 stores information such as the time of day clock and machine
  1595. name in non-volatile memory.  The memory is backed up by a Lithium
  1596. battery, that does die after a few years.  The battery is normally
  1597. located in the right side of the case, near the cards, and connected to
  1598. the motherboard under the card in slot 2.  Replacing the battery almost
  1599. always requires the complete removal of the card cage.  Replacement
  1600. batteries can be found at some electronics stores.  I won't list exact
  1601. specifications because I have seen 3 different types of batteries so
  1602. far, and there may be more.  Your best bet is to just buy another
  1603. batter with the exact same voltage and modify the connector to fit.
  1604.  
  1605. ------------------------------------------------------------------------------
  1606. Subject: 14 Is there an implementation of SLIP for the 3B2?
  1607. ------------------------------------------------------------------------------
  1608.  
  1609. Rumor has it that there was one written by Wollongong, but AT&T
  1610. purchased exclusive marketing rights to WIN TCP/IP for the 3B2, but
  1611. chose NOT to include SLIP.  There is the NOS (KA9Q) package that
  1612. supposedly provides SLIP capabilities, but I have not tried it and
  1613. don't know if it'll run on a 3B2.
  1614.  
  1615. ------------------------------------------------------------------------------
  1616. Subject: 15 What are the known bugs in the Wollongong WIN TCP software?
  1617. ------------------------------------------------------------------------------
  1618.  
  1619. From: Steven M. Kilby <skilby@ucqais.cba.uc.edu>
  1620.  
  1621. rexecd:
  1622.     The rexecd released with WIN TCP for the 3B2 has the following bug.
  1623. This bug has been verified on a 400 with TCP 3.0.1 and 3.2.  When executing
  1624. a command using the rexecd daemon, the gid of the user is set and left at
  1625. root.  This is very apparent when executing a command that creates a shell,
  1626. such as XTerm.  The only available solutions at present are to rewrite the
  1627. daemon yourself, or.... not run it.  The problem has been reported to CERT.
  1628.  
  1629. ------------------------------------------------------------------------------
  1630. Subject: 16 Is there an implementation of NFS for the 3B2?
  1631. ------------------------------------------------------------------------------
  1632.  
  1633. The person to contact about 3B2 software is Kristine Schneider
  1634. [708-979-1017].  I called her and obtained the following information
  1635. about NFS:
  1636.  
  1637. Latest Versions:        1.3
  1638. Requires:               System V Rel 3.2.1 or 3.2.3, WIN/TCP 3.2 or higher
  1639. Product Code:           C274-0NB3-000
  1640. List Price:             $1295.00
  1641.  
  1642. This package is for the WE versions of the 3B2.  NFS comes bundled with
  1643. SVR4 for RISC-based 3B2's.  TCP/IP on the other hand, does not and has
  1644. to be purchased separately.
  1645.  
  1646. ------------------------------------------------------------------------------
  1647. Subject: 17 What are the pinouts of those phone-like serial connectors?
  1648. ------------------------------------------------------------------------------
  1649.  
  1650. The connectors 3B2's use are called RJ-45.  They are 8 conductor
  1651. telephone like connectors, and lucky for us, are pretty standard.
  1652. You can either buy the cables and connectors from AT&T for an arm
  1653. and a leg, or elsewhere.  I don't know about the cables, since I've
  1654. never bought them from anyone but AT&T, but I have made my own
  1655. RS-232 connectors with excellent results.
  1656.  
  1657. The following is an excellent description of the RJ-45 port on the
  1658. 3B2:
  1659.  
  1660. From: rthomas@hakatac.almanac.bc.ca (Robert N Thomas)
  1661.  
  1662. Looking into the 8 pin modular RJ-45 jack you'll see that pin 1
  1663. should be on the right.
  1664.  
  1665.     Diagram of what you should see when looking
  1666.     at an 8 PIN modular jack connector.
  1667.  
  1668.                +----------+
  1669.                | 87654321 | 
  1670.                |          |
  1671.                +--+    +--+
  1672.                   |    |
  1673.                   +----+
  1674.  
  1675. Ok, not all 3B2 8 pin modular jack connectors are created "EQUAL".
  1676. These beasties are used for running StarLan 1MBit, EPORTS cards,
  1677. PORTS cards, as well as for running ETHERNET 10MBits as well.
  1678.  
  1679. The pin outs for the two modular jack cables on the back of the
  1680. 3B2, as well as for the PORTS card should be as follows:
  1681.  
  1682.      PIN     Lead           Direction             Explanation
  1683.     =====  ==========     =============         ========================
  1684.       1     PROT GRD                              Ground
  1685.       2     reserved                              Not Connected
  1686.       3     TXD0            Out                   Transmit Data
  1687.       4     DTR0            Out                   Data Terminal Ready
  1688.       5     RXD0            In                    Receive Data
  1689.       6     DCD0            In                    Data Carrier Detect
  1690.       7     SIG GRD                               Signal Ground
  1691.       8     reserved                              Not Connected
  1692.  
  1693. The 2 modular jacks on the back of your machine should be labeled
  1694. console and contty.  If your talking about a PORTS card, here is
  1695. what one looks like:
  1696.  
  1697.      Centronics connector
  1698.      for Parallel Printer
  1699.           |
  1700.          \|/
  1701.      +------------+     +----+    +----+    +----+   +----+
  1702.       \          /      |    |    |    |    |    |   |    |
  1703.        \________/       +-__-+    +-__-+    +-__-+   +-__-+
  1704.  
  1705.                            ^         ^        ^        ^
  1706.                           The above 4 RJ45 connectors are for
  1707.                         plugging serial terminals into your 3B2.
  1708.  
  1709. The EPORTS card is card that has 8 RJ45 connectors (8 pin modular
  1710. jacks) on it.  This card is where you would want to plug a high
  1711. speed modem onto your system, because the above connectors DO NOT
  1712. SUPPORT HARDWARE FLOW CONTROL.  The PIN OUTS for the EPORTS card
  1713. is as follows:
  1714.    
  1715.      PIN     Lead           Direction             Explanation
  1716.     =====  ==========     =============         ========================
  1717.       1     PROT GRD                              Ground
  1718.       2     CTS             Out                   Clear to Send
  1719.       3     TXD0            Out                   Transmit Data
  1720.       4     DTR0            Out                   Data Terminal Ready
  1721.       5     RXD0            In                    Receive Data
  1722.       6     DCD0            In                    Data Carrier Detect
  1723.       7     SIG GRD                               Signal Ground
  1724.       8     RTS             In                    Request to send
  1725.  
  1726. * NOTES:
  1727.  
  1728. CTS & RTS (if you have them).
  1729.     Most 3B2 systems need to do the following to enable hardware
  1730.     flow control.  Otherwise the 3B2 will ignore RTS & CTS.
  1731.     Also see the FAQ item about handing high speed modems on
  1732.     EPORTS cards for more detailed information.
  1733.  
  1734.     epstty hfc    <-- XON/XOFF flow control must be disabled
  1735.               before you do this.  The stty command is
  1736.               one way to disable XON/XOFF.  Line
  1737.               DISCIPLINES are another way to do this.
  1738.               See etc/gettydefs file.
  1739.  
  1740. DTR0 notes. {3B2 uses this to signal DISCONNECT}
  1741.  
  1742.     When the 3B2 is active on the port  (waiting for someone
  1743.     to logon to the port or whatever.), DTR is active.   When
  1744.     the 3B2 wishes to DISCONNECT (ie, too many wrong passwords,
  1745.     or the user logs off the port), it will lower DTR momentarily.
  1746.     If you are trying to get a modem to work, you might want
  1747.     the modem to DISCONNECT the user when DTR is dropped..
  1748.  
  1749. DCD0 notes. {Used to tell 3B2 that the user has DROPPED CARRIER}
  1750.  
  1751.     When the DCD is set inactive, the 3B2 will assume that the
  1752.     user has either turned off the terminal, or dropped carrier.
  1753.     If this occurs, the user is logged off the system, and
  1754.     background tasks are aborted.  If DCD is inactive, be
  1755.     aware that NONE of the standard AT&T provided utilities
  1756.     are capable of sending anything to the device.  There is
  1757.     a way to get around this in the more recent releases of
  1758.     the 3B2's OS.  See your admin documentation for details.
  1759.  
  1760.     Otherwise, in the case of a MODEM, when the user drops
  1761.     carrier, you want the modem to "momentarily" lower this
  1762.     DCD0 just long enough for the 3B2 to realize that the user
  1763.     has dropped carrier.  The modem should then Re-ENABLE DCD0,
  1764.     so that the 3B2 will be able to send data to the modem.
  1765.     {needed for cu, and outbound UUCP to work correctly in
  1766.     older releases of the OS}
  1767.  
  1768.     Most semi-decent modems are capable of handling DCD and
  1769.     DTR in a 3B2 friendly manner.  I have done this with PEP's,
  1770.     USR HST's, and MicroComm 9600 AX modems, without incident.
  1771.  
  1772. ------------------------------------------------------------------------------
  1773. Subject: 18 What is the u3b. newsgroup heirarchy?
  1774. ------------------------------------------------------------------------------
  1775.  
  1776. Don't worry about it, you're not missing anything.  It's an almost
  1777. completely dead heirarchy that used to be about 3B2's and 3B1.
  1778. Discussions about 3B2's have migrated to comp.sys.att, and discussions
  1779. about 3B1's have migrated to comp.sys.3b1.
  1780.  
  1781. ==============================================================================
  1782. If you have any other questions, or better answers, please send
  1783. mail to 'greg@gagme.chi.il.us'
  1784. ==============================================================================
  1785. -- 
  1786. Gregory A. Gulik                                 Call Gagme, a public access
  1787.        greg@serveme.chi.il.us                    UNIX system at 312-282-8606
  1788.    ||  gulik@rtsg.mot.com                        For information, drop a note
  1789.                          to info@gagme.chi.il.us
  1790.